package com.ruoyi.sales.service;

import java.util.List;
import com.ruoyi.sales.domain.SalesOrder;

/**
 * 销售订单主Service接口
 * 
 * @author ruoyi
 * @date 2025-06-17
 */
public interface ISalesOrderService 
{
    /**
     * 查询销售订单主
     * 
     * @param orderId 销售订单主主键
     * @return 销售订单主
     */
    public SalesOrder selectSalesOrderByOrderId(Long orderId);

    /**
     * 查询销售订单主列表
     * 
     * @param salesOrder 销售订单主
     * @return 销售订单主集合
     */
    public List<SalesOrder> selectSalesOrderList(SalesOrder salesOrder);

    /**
     * 新增销售订单主
     * 
     * @param salesOrder 销售订单主
     * @return 结果
     */
    public int insertSalesOrder(SalesOrder salesOrder);

    /**
     * 修改销售订单主
     * 
     * @param salesOrder 销售订单主
     * @return 结果
     */
    public int updateSalesOrder(SalesOrder salesOrder);

    /**
     * 批量删除销售订单主
     * 
     * @param orderIds 需要删除的销售订单主主键集合
     * @return 结果
     */
    public int deleteSalesOrderByOrderIds(String orderIds);

    /**
     * 删除销售订单主信息
     * 
     * @param orderId 销售订单主主键
     * @return 结果
     */
    public int deleteSalesOrderByOrderId(Long orderId);
    
    /**
     * 审核通过销售订单
     * 
     * @param orderId 订单ID
     * @param auditOpinion 审核意见
     * @return 结果
     */
    public int approveOrder(Long orderId, String auditOpinion);
    
    /**
     * 审核拒绝销售订单
     * 
     * @param orderId 订单ID
     * @param auditOpinion 审核意见
     * @return 结果
     */
    public int rejectOrder(Long orderId, String auditOpinion);
    
    /**
     * 执行销售订单
     * 
     * @param orderId 订单ID
     * @param executionRemark 执行备注
     * @return 结果
     */
    public int executeOrder(Long orderId, String executionRemark);
    
    /**
     * 执行销售订单（指定账户）
     * 
     * @param orderId 订单ID
     * @param executionRemark 执行备注
     * @param accountId 财务账户ID
     * @return 结果
     */
    public int executeOrder(Long orderId, String executionRemark, Long accountId);

    /**
     * 批量审核通过销售订单
     * 
     * @param orderIds 订单ID数组
     * @param auditOpinion 审核意见
     * @return 结果
     */
    public int batchApproveOrders(String orderIds, String auditOpinion);
    
    /**
     * 批量审核拒绝销售订单
     * 
     * @param orderIds 订单ID数组
     * @param auditOpinion 审核意见
     * @return 结果
     */
    public int batchRejectOrders(String orderIds, String auditOpinion);
    
    /**
     * 批量执行选中的销售订单
     * 
     * @param orderIds 订单ID字符串，多个ID用逗号分隔
     * @param executionRemark 执行备注
     * @param accountId 财务账户ID
     * @return 成功执行的订单数量
     */
    public int batchExecuteOrders(String orderIds, String executionRemark, Long accountId);
}
